home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 1998 November / IRIX 6.5.2 Base Documentation November 1998.img / usr / share / catman / p_man / cat3 / Xm / XmeDropSink.z / XmeDropSink
Text File  |  1998-10-30  |  12KB  |  133 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk - A toolkit function that establishes a widget
  10.           as a drop site
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           #include <Xm/TransferP.h>
  14.           vvvvooooiiiidddd XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk(
  15.           WWWWiiiiddddggggeeeetttt wwwwiiiiddddggggeeeetttt,
  16.           AAAArrrrggggLLLLiiiisssstttt aaaarrrrggggssss,
  17.           CCCCaaaarrrrddddiiiinnnnaaaallll aaaarrrrgggg____ccccoooouuuunnnntttt);
  18.  
  19.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  20.           This page documents Motif 2.1.
  21.  
  22.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  23.           XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk establishes a widget as a drop site for drag and
  24.           drop operations.  This routine calls XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeRRRReeeeggggiiiisssstttteeeerrrr with
  25.           the widget specified in _w_i_d_g_e_t and the arguments specified
  26.           in _a_r_g_s.  It overrides any setting of XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc in _a_r_g_s.
  27.  
  28.           This routine sets the DropSite's XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc to a function
  29.           that initializes an XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt as follows:
  30.  
  31.              +o  Sets the _s_e_l_e_c_t_i_o_n member to ____MMMMOOOOTTTTIIIIFFFF____DDDDRRRROOOOPPPP.
  32.  
  33.              +o  Sets the _o_p_e_r_a_t_i_o_n member to the following value:
  34.  
  35.                    +o  XXXXmmmmCCCCOOOOPPPPYYYY, if the _o_p_e_r_a_t_i_o_n member of the
  36.                       XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
  37.                       XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc is XXXXmmmmDDDDRRRROOOOPPPP____CCCCOOOOPPPPYYYY and the ddddrrrrooooppppAAAAccccttttiiiioooonnnn
  38.                       member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt is not
  39.                       XXXXmmmmDDDDRRRROOOOPPPP____HHHHEEEELLLLPPPP.
  40.  
  41.                    +o  XXXXmmmmMMMMOOOOVVVVEEEE, if the _o_p_e_r_a_t_i_o_n member of the
  42.                       XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
  43.                       XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc is XXXXmmmmDDDDRRRROOOOPPPP____MMMMOOOOVVVVEEEE and the ddddrrrrooooppppAAAAccccttttiiiioooonnnn
  44.                       member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt is not
  45.                       XXXXmmmmDDDDRRRROOOOPPPP____HHHHEEEELLLLPPPP.
  46.  
  47.                    +o  XXXXmmmmLLLLIIIINNNNKKKK, if the _o_p_e_r_a_t_i_o_n member of the
  48.                       XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
  49.                       XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc is XXXXmmmmDDDDRRRROOOOPPPP____LLLLIIIINNNNKKKK and the ddddrrrrooooppppAAAAccccttttiiiioooonnnn
  50.                       member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt is not
  51.                       XXXXmmmmDDDDRRRROOOOPPPP____HHHHEEEELLLLPPPP.
  52.  
  53.                    +o  XXXXmmmmOOOOTTTTHHHHEEEERRRR, if the _o_p_e_r_a_t_i_o_n member of the
  54.                       XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the
  55.                       XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc is XXXXmmmmDDDDRRRROOOOPPPP____NNNNOOOOOOOOPPPP or if the ddddrrrrooooppppAAAAccccttttiiiioooonnnn
  56.                       member of the XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt is
  57.                       XXXXmmmmDDDDRRRROOOOPPPP____HHHHEEEELLLLPPPP.
  58.  
  59.              +o  Sets the _d_e_s_t_i_n_a_t_i_o_n__d_a_t_a member to a pointer to the
  60.  
  61.  
  62.  
  63.      Page 1                                         (printed 10/24/98)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk((((3333XXXX))))           UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV           XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk((((3333XXXX))))
  71.  
  72.  
  73.  
  74.                 XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc.
  75.  
  76.              +o  Sets the _t_i_m_e member to the ttttiiiimmmmeeeeSSSSttttaaaammmmpppp member of the
  77.                 XXXXmmmmDDDDrrrrooooppppPPPPrrrrooooccccCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt passed to the XXXXmmmmNNNNddddrrrrooooppppPPPPrrrroooocccc.
  78.  
  79.           XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk makes the following sequence of calls:
  80.  
  81.              1. Calls the destination widget's
  82.                 ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnPPPPrrrreeeeHHHHooooooookkkkPPPPrrrroooocccctrait method, if any;
  83.                 ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnPPPPrrrreeeeHHHHooooooookkkkPPPPrrrrooooccccis one of the trait methods of
  84.                 the _X_m_Q_T_t_r_a_n_s_f_e_r trait.  XXXXmmmmeeeeDDDDrrrrooooppppSSSSiiiinnnnkkkk passes the
  85.                 initialized XXXXmmmmDDDDeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkSSSSttttrrrruuuucccctttt as the
  86.                 _c_a_l_l__d_a_t_a argument.
  87.  
  88.              2. Calls any XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedures that the
  89.                 application has attached to the destination widget.
  90.  
  91.              3. Calls the destination widget's ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnPPPPrrrroooocccctrait
  92.                 method, if any, after all transfers initiated by
  93.                 XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkkprocedures have finished.
  94.                 However, if an XXXXmmmmNNNNddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnCCCCaaaallllllllbbbbaaaacccckkkk procedure has
  95.                 called _X_m_T_r_a_n_s_f_e_r_D_o_n_e with a status of
  96.                 XXXXmmmmTTTTRRRRAAAANNNNSSSSFFFFEEEERRRR____DDDDOOOONNNNEEEE____DDDDEEEEFFFFAAAAUUUULLLLTTTT, XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk does not call
  97.                 the ddddeeeessssttttiiiinnnnaaaattttiiiioooonnnnPPPPrrrroooocccctrait method.
  98.  
  99.           _w_i_d_g_e_t    Specifies the widget that is the drop site.
  100.  
  101.           _a_r_g_s      Specifies arguments to be passed to
  102.                     XXXXmmmmDDDDrrrrooooppppSSSSiiiitttteeeeRRRReeeeggggiiiisssstttteeeerrrr.
  103.  
  104.           _a_r_g__c_o_u_n_t Specifies the number of arguments in _a_r_g_s.
  105.  
  106.      RRRREEEELLLLAAAATTTTEEEEDDDD
  107.           XXXXmmmmQQQQTTTTttttrrrraaaannnnssssffffeeeerrrr(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrDDDDoooonnnneeee(3), XXXXmmmmTTTTrrrraaaannnnssssffffeeeerrrrVVVVaaaalllluuuueeee(3),
  108.           XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSiiiinnnnkkkk(3), XXXXmmmmeeeeCCCClllliiiippppbbbbooooaaaarrrrddddSSSSoooouuuurrrrcccceeee(3),
  109.           XXXXmmmmeeeeCCCCoooonnnnvvvveeeerrrrttttMMMMeeeerrrrggggeeee(3), XXXXmmmmeeeeDDDDrrrraaaaggggSSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeGGGGeeeettttEEEEnnnnccccooooddddiiiinnnnggggAAAAttttoooommmm(3),
  110.           XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSiiiinnnnkkkk(3), XXXXmmmmeeeePPPPrrrriiiimmmmaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSiiiinnnnkkkk(3),
  111.           XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyySSSSoooouuuurrrrcccceeee(3), XXXXmmmmeeeeSSSSeeeeccccoooonnnnddddaaaarrrryyyyTTTTrrrraaaannnnssssffffeeeerrrr(3),
  112.           XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddCCCCoooonnnnvvvveeeerrrrtttt(3), XXXXmmmmeeeeSSSSttttaaaannnnddddaaaarrrrddddTTTTaaaarrrrggggeeeettttssss(3), and
  113.           XXXXmmmmeeeeTTTTrrrraaaannnnssssffffeeeerrrrAAAAddddddddDDDDoooonnnneeeePPPPrrrroooocccc(3).
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129.      Page 2                                         (printed 10/24/98)
  130.  
  131.  
  132.  
  133.